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PREFACE 



This manual describes the operation and use of the PDP-15 PATCH Utility 
Program. The PATCH program may be operated in either the ADVANCED 
Software System CADSSl or the Disk Operating System (DOS) environment. 

NOTE 

In DOS systems , PATCH may be used only by the 
System Manager. 

It was assumed in the preparation of this manual that the reader was 
familiar with the operation of the PDP-15 equipment and the contents 
of the software manual describing the features of the particular 
monitor system in which he was operating, that is: 

a] for ADSS users, PDP-15/20/30/40 ADVANCED Monitor 
Software System Manual, DEC-15-MR2B-D; 

b) for DOS user;-., DOS Software System User's Manual, 
DEC-15-MRDA-D. 

PDP-15 UTILITY PROGRAMS MANUAL, DEC-15-YWZB-D 

The PDP-15 Utility Programs manual is comprised of a set of individual 
manuals, each of which describes the qseration and use of a PDP-15 
Utility Program. The manuals which make up the Utility Programs set 
are listed in the following Application Guide. In addition, the Appli- 
cation Guide also indicates the order number of each manual and the 
specific PDP-15 Monitor Software Systems in which the program described 
may be used. 

The Utility Manuals may be ordered either individually, by using the 
title and order number given with each manual or as a set by referenc- 
ing "PDP-15 Utility Programs Manual, DEC-15-YWZB-D" , 
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APPLICATION GUIDE 



PDP-15 UTILITY PROGRAM MANUALS 



PDP-15 Utility Program Manuals and the Application of Each 
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SECTION 1 



INTRODUCTION 



1.1 PATCH PROGRAM 

The PATCH Utility program enables the PDP-15 user to view and modify 
System Programs and data on specific device data blocks. The commands 
provided by PATCH may be entered via the console keyboard or, in the 
monitor Batch mode, via either paper tape or card reader units. This 
manual is concerned only with user-controlled PATCH operations. The 
operation of PATCH under monitor Batch control is described in the 
applicable monitor (ADSS or DOS) reference manual (see Table 1-1). 

1.2 MANUAL ORGANIZATION AND USE 

This manual is intended for users who are familiar with: 

a) the general operating procedures (i.e., use of equip- 
ment and startup procedures) , 

b) the elements, structures and use of the particular 
monitor software system in which PATCH is to be used. 

Introductory information and detailed descriptions of each PATCH 
function and their agslications are given in Sections 2 through 5. 

Section 6 summarizes the PATCH startup and operating procedures. 

New users of PATCH should familiarize themselves with the contents 
of Sections 1 through 5; thereafter, they need only refer to Section 
6 for concise information. 

Two Appendices are included which contain supplementary System Block 
(SYSBLK) and System Program descriptions. 

SYSBLK is described in Appendix A, System Programs are discussed in 
Appendix B. 
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1.3 SUPPORTING DOCUMENTS 

Table 1-1 lists PDP-15 dociraients which either support directly or con- 
tain information useful in understanding PATCH and its functions. 

Table 1-1 

Supporting Documentation 



TITLE 



ADSS Manuals 



al ADVANCED Monitor Software System 
for PDP-15/20/30/40 

bl PDP-15/20 User's Guide 

cl SGEN ADVANCED Monitor Utility Program 



ORDER NUMBER 

DEC-15-MR2B-D 
DEC-15-MG2B-D 
DEC-15-yWZB-DN3 



DOS Manuals 



al DOS User's Manual 

b) DOS Keyboard Command Guide 

cl SGEN-DOS Utility Program 

di DOSPIP Monitor Utility Program 



DEC-15-MRDA-D 
DEC-15-NGKA-D 
DEC-15-YWZB-DN12 
DEC-1 5-YWZB-DN13 



B/F Monitor Manual 



al PDP-15/30, PDP-15/40 B/F 
Monitor Software Systems 



DEC-15-MR3A-D 



Common Manual 



a) MACR015 MACRO-Assembler Program 



DEC-15-AMZC-D 



1.4 MAJOR PATCH FUNCTIONS 

The items on which PATCH functions may be performed together with a 
description of the commands and procedures needed for their selection 
are given in Section 2. 
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The major functions for which PATCH may be used are: 

a) the loading of relocatable programs into a system as 
a System Program (described in Section 3) ; 

b) the loading of absolute programs and data onto a 
System Program area (described in Section 4) ; 

c) the modification of registers located in 

li System Programs, 

21 Data blocks, 

31 System SYSBLK (system block). 

1.5 PATCH, r/0 DATA FLOW PATHS 

Figure 1-1 illustrates the primary data flow paths employed during 
PATCH operations. 

User command/response operations are carried out via a console/printer 
unit. Peripheral devices/UFD ' s containing the files to be patched 
must be assigned to .DAT-14, those devices containing auxiliary input 
files must be assigned to .DAT-10. 
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, AUXILIARVy 
INPUT 
L DEVICE 



Input Patches & 
Patch Programs 



I.DAT-10 



MONITOR 



PATCH 
PROGRAM 



I.DAT-3 



. DAT-2 



I.DAT-14 I 



Inputs/Outputs 



i-ILE TO BI 
I PATCHED 



CONSOLE TERMINAL 



Outputs 



Commands 




Figure 1-1 PATCH Operations, Information 
Flow Diagram 
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SECTION 2 
SELECTION OF ITEM TO BE PATCHED 

2.1 SELECT FUNCTION 

TB.e first step required in any PATCH procedure is the selection of the 
item C=DAT -14) to be patched. Two basic commands "Program Select", 
and "Block Select" are provided for this purpose. 

2.1.1 Program Select Command 

The System Programs located on the device assigned to .DAT -14 are 
selected for PATCH operations by the entry of a unique name which is 
stored in a monitor table; these unique names enable the monitor to 
identify the requested program. 

The format for a Program Select command is : 

>name^ 
For example, to select the Editor program the entry 

>EDIT^ 

is entered . 

The entry of a System Program name merely identifies the item to be 
operated upon; no further action is taken until a PATCH function is 
initiated by another command. 

NOTE 

The Program Select command may be used only if 
the device assigned to .DAT -14 contains a Sys- 
tem Block (SYSBLK) . 

In addition to System Programs, system Device System Block (SYSBLK) 
and CTRL Q (+QAREA) areas may also be selected for PATCH operations. 
Table 2-1 lists the unique names of the programs normally supplied as 
System Programs with ADSS and DOS software systems. 
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TABLE 2-1 



PATCH Accessible System Programs 



PROGRAM 



1) Resident Monitor 

21 System Loader 

31 Control Q Area 

41 Standard Editor Program 

5] Text Editor for VT15 Graphics Display 

&I Text Editor for VP15 Storage Tube 
Display Unit 

71 Peripheral Interchange Program 

8) Macro-Imbedded Assembler for 8K 
Systems Only 

91 MACR015, Macro-Assembler Program 

10) Cross Reference Program 

111 CHAIN and EXECUTE Program 

121 System Generator 

131 System Generator, Section 2 

14} System Generator, Section 3 

151 FORTRAN IV (16K) 

161 FORTRAN IV Imbedded (8K Systems Only) 

171 Core Diunp Utility Program 

18) Dump Core Program 

19) DECtape Copy Program 
201 PATCH Program 

211 UPDATE Program 

221 Source Compare Program 

23) Task Builder Program (RSX Only) 

24) DOS Monitor 

25) Keyboard Monitor, KM-15 

26) 9-15 Keyboard Monitor, KM9-15 





MONITOR 


NAME 


DOS 


ADSS 


RESMON 


/ 




.SYSLD 


/ 


/ 


+QAREA 


/ 


/ 


EDIT 


/ 


/ 


EDITVT 


/ 


/ 


EDITVP 


/ 


/ 


PIP 


/ 


/ 


MACROI 




/ 


MACRO 


/ 


/ 


CREF 


/ 


/ 


CHAIN 


/ 


/ 


SGEN 


/ 


/ 


.SGEN2 




/ 


. SGEN3 




/ 


F4 


/ 


/ 


F4I 




/ 


QFILE 


/ 




DUMP 


/ 


/ 


DTCOPY 


/ 


/ 


PATCH 


/ 


/ 


UPDATE 


/ 


/ 


SRCCOM 


/ 


/ 


TKB 


/ 




D0S15 


/ 




KM15 




/ 


KM9-15 




/ 
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2.1.2 Block Select (B) 

A single 400o-word data Hock located on the device assigned to .DAT -14 
is selected for PATCH operations, using a "B" Block Select command. 

FORMATS: a) ^^uj":^ 
or 
bl ^B+|_|n^ CDECtape only) 

or 



cl >B-^_,n^ CDECtape only) 



where : 



11 B identifies the Block Select command 

21 + indicates the selected block should be read 
in the forward direction. 

31 ^ indicates that the selected block should be 
read in the reverse direction 

41 n represents an octal number which identifies 

a logical block on the PATCH I/O device (.DAT -14) 
The value of n must be greater than or equal to 



DESCRIPTION: 

The entry of a "B" select command relocates the identified word block 
into a PATCH Block Buffer in core. In relocating the block, the load 
address is set to 0, the size is set to 400g, and the block number is 
as specified. If the block number (n) in any of the select commands 
is followed by a space, any data on the remainder of the input line is 
treated as a comment and is ignored. For example: 



>B 100 COMMENT i 



is permitted. 
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SECTION 3 



LOADING RELOCATABLE PROGRAMS AS SYSTEM PROGRAMS 



3.1 PATCH LOAD FUNCTION 

A PATCH load function enables the user to convert a relocatable file 
into an absolute SYS file format and load the converted file onto a 
system device as a System Program. The PATCH command used, the proce- 
dure required, the relocatable file requirements, and the operations 
performed by PATCH are described in detail in this Section. 

The PATCH load function can only be used when the system on .DAT -14 
has been prepared by SGEN to receive the converted file. During SGEN 
procedures (refer to appropriate SGEN manual) the user must enter the 
name of each program to be installed, specify .DAT slot usage, and 
indicate the order in which the System Programs are to appear in the 
newly generated system. The program name, size, and .DAT slot usage 
information entered during SGEN is stored in the system device SYSBLK. 

3.2 PATCH READR LOAD C0MI4AND 

The command "READR" initiates the PATCH relocatable-to-SYS file pro- 
gram load function. The general format of this command is as follows: 

>READR [nnnnnj [filenamej lextj IcommentsJ ") 

where : 

nnnnn = the highest 13 -bit core address to be occupied by 

the relocated file when it is loaded into core as 

a SYS file. If an address is not specified, the 

first free register below the bootstrap is assumed 

by PATCH. If specified, the value of nnnnn must 

be <17636o; a larger value will cause an error. 
— o 

filename the name of the relocatable file. 

ext = filename extension; if not given, BIN is assumed. 

comments if desired, a comment may be added to the command 

string, but only if the extension is given explicitly. 



"^NOTE: FILE name ma^' be om.itted for non-file oriented auxiliary 
devices (.DAT -10). 
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3.2.1 Procedures 

T&e READR command must be preceded by a program select command which 
identifies the system device area (named in SGEN) into which the modi- 
fied file is to be written. For example, the sequence: 

>8TRN^ 

>READR 8TRAN^ 

must be entered to install the file 8TRAN onto a prepared system de- 
vice at .DAT-14, given the name 8TRN. 

On the execution of a READR command, PATCH obtains the named file from 
.DAT-1^ and checks it for required size and program characteristics 
Csee paragraph 3.2.2). If the file is not acceptable, the load opera- 
tion is halted and an appropriate error message is output to the user. 

If the file is acceptable, PATCH relocates addresses within the input 
file, builds a table of the transfer vectors contained by the file, 
and appends the table and a Bank Bit Initialization routine to the 
file. The modified file and its appended routine and vector table are 
tlien loaded as a unit, in core image form, onto the system device at 
.DAT-14. 



PATCH automatically changes the patch parameters in SYSBLK. Relocation 
and the Bank Bit Initialization routines are described in paragraphs 
3.3 and 3.4, respectively. 



3.2.2 Input File Requirements 

In order to be installed onto a system as a SYS file, a relocatable 
file at .DAT-1J3 must: 

1) not contain more than 256 transfer vectors; 
21 not contain external .GLOBL references; 
31 not use indexed instructions 

4) not have a core image size greater than the number of 
system blocks allocated multiplied by 4JJJ?q. 

5) not cause the total program size to exceed 8K. 

6) not contain COMMON references 
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NOTE 



The total installed size of a program may be computed 
by adding 1) the size of the binary program, 2) the 
number of transfer vectors, and 3) 32g word locations 
which are occupied by the Bank Bit Inxtialization 
routine. 



3.3 RELOCATION 

MACRO-15 outputs relocatable programs addressed as if they were as- 
sembled starting in location of core. Relocatable programs are 
normally loaded into core for execution by the Linking Loader System 
Program which, at load time, computes the difference between the 
MACRO-as signed addresses and the addresses of the actual core area 
into which the program is to be loaded for execution. This computed 
difference, called the relocation factor, is then added to each loca- 
tion address contained by the program as it is loaded into memory. 
The relocation factor properly orients the relocatable program within 
memory. 

3.3.1 PATCH READR File Relocation 

During the execution of a READR command, PATCH calculates the required 
13-bit relocation factor by subtracting the program size from the 
final (highest) address the program is to occupy. The final address 
is either specified in the READR command by the user or, by default, 
17636g is assumed. 

The relocation factor, recognized by PATCH as the symbol #, is then 
incremented by 1 for each word location and the resulting value as- 
signed as the address of the location. For example, the relocation 
factor (#) for a relocatable program A00q words in size with no address 
specified in the READR command would be calculated: 

# = 17636g - 4jaj2fg + 1 = 17237g 

In order to relocate the program addresses (J2f through 377) for con- 
version to the absolute values required for SYS files, PATCH then 
increments the relocation factor by 1 for each position and assigns 
each value obtained as an address to the corresponding program word 
location; i.e.. 
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# + = address of first word location (17237.) 

# + 377 = address of last program word location (1763 6-) 

PATCH also relocates the addresses contained by the memory reference 
instructions and transfer vectors found in the input program. 

3.4 BANK BIT INITIALIZATION (BBI) ROUTINE 

Transfer vectors contain 15-bit addresses which include bank identity 
bits in addition to the 13 -bit, 8K word location addresses. The format 
of a Transfer Vector data word and the interpretation of its address 
portion is : 






1 


2 


3 


4 


5 


6 




17 



I 



I 



BANK 



BANK 
BITS j 




I 





1 


1 



13-bit BANK WORD LOCATION ADDRESSES 



00000_ to 17777„ 

20000g to 37777" 

40000" to 57777" 

60000g to 77777g 



During READR relocation operations the relocation factor is added to 
the least significant 13 word bits of the Transfer Vector to relocate 
the bank, word address which it contains. The bank bits of a Transfer 
Vector cannot be relocated at the time the file is installed as a System 
Program since the number of the highest bank of a system varies ac- 
cording to the overall size of the system. 

To ensure that transfer vector bank bits are relocated prior to run 
time, PATCH, during READR operations, develops a table of transfer 
vector locations, adds the table to a Bank Bit Initialization routine, 
and appends the routine to the input program. The BBI routine is 
installed onto the system device medium as part of the new System 
Program. 

When a READR-ins tailed program is loaded into core, its associated 
BBI is also loaded immediately below the program (see Figure 3-1). 
The loader, .SYSLD, on completion of its functions, turns control 
over to the BBI routine. The BBI routine determines what bank the 
System Program has been loaded into and updates the bank bits of all 
Transfer Vectors contained by the program. The routine identifies 
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the vector words from the Transfer Vector table developed during 
PATCH READR operations. 

On completion of its initialization function, this routine sets the 
contents of the .SCOM+3 pointer to tie address of the last word loca- 
tion occupied by the routine and turns control over to the System 
Program. 

The modification of .SCOM+3 at the end of BBI functions frees the 
core occupied by this routine for use by the System Program. 

The basic portion of the BBI routine requires 32g word locations. 
The routine Transfer Vector table requires an additional location for 
each Vector in the program. A maximum of 400 „ vectors is permitted. 

The PATCH appended BBI routine relives the user of the responsibility 
of including a routine to perform this. function. 

3.5 READR ESTABLISHED SYSTEM COMMUNICATIONS AREA 

The ability to specify in the READR command the highest load address 
for the program being loaded permits a buffer area to be set up 
between the last program address and the first address of the boot- 
strap. Such a buffer would provide READR-loaded programs with a 
common core-resident buffer for intra-program communications and/or 
common data storage. 



BOOTSTRAP 



BUFFER AREA 



SYSTEM PROGRAM 



BBI 



•< — 17777, 



-e— 17636, 



-Specified Address 
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3 . 6 LOADING PATCH-RELOCATED CORE IMAGE SYSTEM PROGRAMS 

READR-installed Systems Programs and their associated Device Handlers 
are loaded into core from the system device by the System Loader 
(.SYSLD) program. 

The placement of READR-installed System Programs and their device 
handlers in core is illustrated in Figure 3-1. 
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EXTRA 
4K PAGE 



BOOTSTRAP' 



SYS-FILE 



BANK BIT 
INITIALIZATION 
ROUTINE (BBI) 



LEGEND: N is: 

00000 for 8K 
20000 for 16K 
4OOOO3 for 24K 
60000„ for 32K 



Villi ^ + N 



17636„ + N 



.SCOM + 3 Adjusted value 
after BBI initialization 
operation 

.SCOM + 3 Initial Value 




00020 Q + N Lowest Limit for 

SYS file $ initializa- 
tion routine 



DEVICE 
HANDLER tS) 



RESIDENT 
MONITOR 



.SCOM + 2 



,SCOM + 1 



^An extra 4K page is not used for 
loading core image programs, 
it is used only for handlers. 



■p-; „,,-^„ 0_1 Mr>TV.^-.-Tr M^y-, T^^f^^-r^rr a "PT? B FIT? — T n c: -f- ;^ 1 T f:»rl 

SYS-file on the ADSS Monitor 
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SECTION 4 



LOADING ABSOLUTE PROGRAMS AND DATA 



4.1 READ AND PATCH FILE FUNCTIONS 

TElls section contains detailed descriptions of the READ load function, 
the function user commands, and the load operation. Patch files, the 
input sources to PATCH during READ load function, are also described 
in detail. 

4.2 READ LOAD FUNCTION 

The "READ" load function enables the user to transfer absolute "Patch 
files" from the auxiliary input device (.DAT-10) into a user-selected 
program or data block located on the device at .DAT -14. 

A Patch file is an absolute program written by the user to operate with 
the PATCH READ load function; its purpose is to direct the PATCH program 
in loading information contained by the file into a specific register 
or series of registers located within a program or data block of the 
device on .DAT-14. Entire programs or data blocks, as well as selected 
items, may be loaded from Patch files onto the device at .DAT-14, using 
the PATCH READ load function. 

Patch files are used as a means of making changes (i.e. patches) to 

SYS files or a device data block or of installing a new version of a 

System Program onto a system device. They are particularly useful when 

the same patches are to be made to a SYS file contained by more than 

one system device. 

NOTE 

When patching or replacing a System Program, care 
must be taken to ensure either that the existing 
SYSBLK parameters are not affected or that they 
are changed to comply with the characteristics of 
the replacement version of the program (see 
paragraph 4.5) . 

4.3 READ COMMAND 

The command READ initiates the performance of the absolute load 
function. This command may have any of the following formats: 

a) >READ^ (for non-directoried devices only ) 

b) >READi_,[filename]_^ 

c >READi_i[filename]i_i[ext]^ 

4-1 



where: 1) filename is the name of the Patch file to be input 
from .DAT-10. The use of a filename extension 
(format c) is optional. If not given, the extension 
is assumed to be ABS . 

2) Comments may be added to command strings having the 
format shown in item c. 

3) Patch files on paper tapes do not require a 
filename Csee item a) . 

NOTE 

The READ command must be preceded by either a 
Program Select or Block Select command. The 
patch file read must be a .ABS macro program. 



4.3.1 READ Load Operation 

During READ command load operations, PATCH loads into core one 400 „- 
word block at a time from both the Patch File and the selected program 
or data block. Once both blocks are loaded, PATCH processes in 
sequence each word of the Patch File block. Using reference data 
supplied in the Patch File, PATCH determines the address within the 
user selected program or data block which corresponds to that 
addressed by the Patch File word being processed. If the addressed 
register is within the selected program or data block currently in 
core, the contents of the Patch File word are loaded into that 
register by PATCH. 

If the addressed register is not in the block currently in core, the 
block in core is written back into the device at .DAT-14 and the block 
containing the addressed register is loaded. After the new block is 
loaded, PATCH locates the addressed register and writes the contents 
of the Patch File word into it. 

A user-selected data block is handled, during READ operations, as if 

it were an absolute program having addresses ranging from ^^^^p 

through ^^^11 r,. If more than one data block is to be patched, a 
o 

separate Patch File is required for each block and individual Select . 
Block and READ commands must be issued for each. 

If a Patch File word addresses a location not within the limits of 
the selected program or block, PATCH outputs an ADDRESS OUT OF 
RANGE error to the user console teleprinter (refer to Section 6 
for description of error messages) . 



4-2 



4 . 4 WRITING PATCH PROGRAMS 

The following is an example of the proper format for a PATCH assembly 

source program to be assembled and output by MACRO-15: 



PATCH FILE 




.TITLE 
.ABS 
.LOG 
734777 


anything 

NLD 

234 


6J3J3261 
.LOG 
-3 
• LOG 


35^ 
371 



p4j3674 



MEANING AND OPERATION PERFORMED 



No Loader. 

Set location counter to address 234, 

Set contents of 23 4 to 734777, and 

go to next location. 

Set contents of 23 5 to 6jZ(i?261. 

Advance counter to location 35j3. 

Set contents of 35j0 to -3. 

Advance location counter to 

address 371. 

Write )34^674 into LOG 371 



.END 



End program. 



As illustrated in the above example, .LOG statements in the patch 
program are recognized by PATCH as pointers. These pointers direct 
PATCH to start a replacement operation at a specified address in the 
program or data block being patched. In the replacement (overwrite) 
operation, the contents of the Patch File location immediately follow- 
ing the .LOG statement is written, by PATCH, into the selected program 
or data block location pointed to by the .LOG address. PATCH then 
writes, in sequence, the contents of the following Patch File locations 
into the registers of the file being patched immediately following the 
one pointed to by the patch file .LOG statement. All patches are 
written as if the program is to be loaded into the first bank (13 
bit addresses) . All transfer vectors in a .ABS program must be 
bank-bit initialized before use. 
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The current replacement operation continues until another .LOG state- 
ment is reached in the input Patch File. The new .LOG statement ends 
the current replacement operation and directs PATCH to go to a new 
start location and to start another replacement operation. 

The Patch File operations are terminated when PATCH reaches the PATCH 
File .END statement. 

4.4.1 Partial Overlay Patch Programs 

A Patch Program written to change the contents of specific locations 
or groups of contiguous locations throughout a selected program or 
data block acts as a partial patch to the file being modified; only 
those items specified in the Patch Program are affected. The Patch 
Program in example in paragraph 4.4 represents a partial patch. 

Patch programs may only be used to change the contents of registers 
already existing within a selected program or data block; they cannot 
be used to insert information between existing program lines. 

4.4.2 Replacing Complete Programs or Data Blocks 

Patch Programs may be written to replace an entire absolute System 
Program or 400g-word data block. To accomplish this, the user sets 
the first Patch File .LOG statement to point to the first location 
of the program ordata block to be replaced and follows it with the 
replacement program or data block. For example: 

•TITLE (Patch Program name) 

. ABS NLD 

•LOG (First Location of selected program or 

■f data block) 

Replacement 

Program or 

Block 
I 

.END 



4 . 5 PRECAUTIONS TO BE OBSERVED FOR PATCH READ OPERATIONS 

The PATCH READ load operation does not modify (i.e., update) SYSBLK on 
completion of the function. If any changes are made to a System Program 
which affect the parameters stored for it in SYSBLK, the user must 
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change these parameters using the PATCH List function (described in 
Section 5). Indexed instructions are not permitted. 

When overlaying a complete program with a new version, the user must 
ensure that the new version will fit into the area allotted to that 
program during SGEN. All .ABS program transfer vectors must be bank- 
bit initialized by the program itself before it uses them if the core 
image is loaded above 8K. 
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SECTION 5 



LISTING AND MODIFYING PROGRAM AND DATA BLOCK REGISTERS 



5.1 REGISTER MODIFICATION FUNCTIONS 

This section describes ttie functions, commands and procedures which 
enable the user to select and modify individual registers within: 

al SYS files initially written as absolute programs, 

bi READR-installed SYS files, 

c) a system device SYSBLK Program Parameter Table, and 

dl a system save, fQAREA, area. 

5.2 PATCH LIST FUNCTION 

PATCH register modification is carried out as a list operation in 
which the address and contents of each register selected by the user 
are listed (printed! on the user's console teleprinter. On completion 
of the print operation, the user may enter, if desired, an expression 
to replace the contents of the currently listed register. When the 
user is through with the currently selected register, he terminates 
that operation and either terminates the function or directs PATCH 
to list the contents and address of another register. The program 
or data block containing the register (s) to be modified must be 
identified by the entry of a Select command (see Section 2) ; the 
specific register to be viewed and modified (if desired) is selected 
by the user with a "List" command. Three types of List commands are 
provided by PATCH: 

a] L command , used to select and initiate the list 
operation for registers within any selected SYS- 
file, data block, SYSBLK or QAREA contained by 
the device on .DAT -14. 

b] LR command , used only for the selection and list- 
ing of registers within READR-installed SYSfiles. 

c] SYSBLK Program Parameter Commands , five separate 
commands, each of which initiates the list opera- 
tion for a specific SYSBLK parameter for the cur- 
rently selected SYSfile. Used only with SYS files. 

The format and use of the above List commands are described in para- 
graphs 5-3, 5-4, and 5-5, lEspectively . 
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5.2.1 List Operation 

The PATCH operations performed during a List operation are: 

al On the entry of a list command, PATCH loads the 400g 
word data block or selected Program block containing 
the user identified register into core. The selected 
register is opened by PATCH and its address and con- 
tents are printed on the console teleprinter unit. 

bl PATCH waits for the entry of a modifier and/or a 
terminator. 

cl PATCH writes the input modifier (if made) into the 
opened register and examines the line terminator to 
determine the next operation to be performed. De- 
pending on the terminator entered (see 5.2.3) PATCH 
terminates the List function or opens another 
register. 

5.2.2 Expressions 

Expressions, as defined for MACRO-15 (see DEC-15-AMZA-D) , are strings 
of symbols and numbers separated by arithmetic or Boolean operators. 
Octal numbers of from one to six digits {£f to 111111^) or alphanumeric 
symbols of from one to three characters may be used as expressions or 
as components of an expression. 

Xn PATCH List operations, expressions are entered as replacements for 
the. contents of a program or data block register. Expressions entered 
to change or modify a data word consist of up to six octal digits, 
originally preceded by a minus sign; those entered for an instruction 
word consist of an instruction operation code and an operand. PATCH 
contains symbol tables for all of the PDP-15 basic instructions op- 
codes and the operate group instructions with the octal values of 
each. The user can, therefore, patch registers using symbolic rather 
than octal representations of MACRO instructions (e.g., an expression 
may be entered as LAC 17536 instead of its octal form, 217535). 

The operators recognized by PATCH are listed in Table 5-1. 
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TABLE 5-1 
Operators Recognized by PATCH 

OPERATOR FUNCTION 

- Two's complement subtraction 

! Inclusive OR 



Two ' s complement addition 




The asterisk (*) in addition to its use as an operator, also sets the 
indirect bit of the expression by causing 20000„ to be XORed into the 
value of the expression. The XOR operation occurs each time that the 
symbol (*) is encountered; two sequential asterisks negate the setting 
of the indirect bit. 

** = 20000 XOR 20000 = 

The value of a PATCH expression is null (no modification is made to 
the opened register) unless the expression contains a number, symbol 
or an asterisk. 

Expressions are evaluated from left to right assuming an initial value 
of zero followed by a + operator (i.e., + User's expression). Lead- 
ing and trailing operators are legal in an expression but the latter 
are ignored. Whenever a string of consecutive operators is used, only 
the last one in the string is used by PATCH in evaluating the expression. 

NOTE 

The LAW symbol is a special case in PATCH; it should 
be used only in the following ways: 

a) LAW n which is equivalent to 1S0000+ti 

h\ LAW. , -n which is equivalent to -n. 

The use of LAW in any manner other than that described 
below will result in an error. 
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5.2.3 List Operation, Line Tejnninator 

When all list operations for an opened register are completed, one of 
four possible Line Terminators is entered to close the register and 
indicate the next list operation. The line terminators are described 
in Table 5-2. 



Table 5-2 List Operations, Command String Terminators 



ENTRY 
) 



DESCRIPTION 



Carriage Return 



Up Arrow and Carriage 
Return 



Back Arrow and Car- 
riage Return 



ALT MODE 



OPERATION 

Open and list the next sequential 
register 

Open and List the register which 
precedes the current register. 
Treat any entries after + as a 
comment. 

Open and list the contents of the 
register pointed to by the address 
portion of the word contained in the 
currently opened register. Treat 
any entries after -t- as a comment. 

Terminate current list operation; 
write PATCH buffer block onto 
.DAT -14 and wait for next entry. 



5.3 L List Command 



The L List command has the following format: 



where 



L|_in) 



a) L initiates the list operation, and 

b) n represents the octal form of the 13-bit address of 
the location to be opened. When the L command is used 
to open registers of READR-installed SYS files the 
address n must be the relocated (i.e., address after 
relocation) value. 
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The response to an L command is a printout having the following format: 



>address of opened location) / (contents of opened location) > 

EXAMPLE 



>L 132 
>j30132/777435> 



(location I325.; contents 777435o) 



After outputting the address and contents of the accessed location, 
PATCH prints its go-ahead symbol (>) and waits for: 

1) the entry of an expression to replace the current con- 
tents, to modify the opened location. 

For example: 

> (address)/ (current contents) > (expression-new contents) 

2) the entry of selected string terminator to indicate the 
next sequential list operation. 

5.3.1 Example: Select, List and Modification Procedures 

The following illustrates the use of PATCH select and list commands in 
the modification of a hypothetical system program named JOVE. 



PROCEDURE 
>JOVE 



^001j2f|2f/7 



77435> ^ 



.ef01gl/600200> 213775 



. ,gf0102/111215> 003jg)2f-i- J 



^00300/000110>iJ 



j00277/703112>@ 



DESCRIPTION 

Select System Program JOVE. 

Initiate List operation starting at loca- 
tion 100 

PATCH prints address and contents of 
opened location; user enters J to go to 
and open next sequential location. 

Address and contents of location 101 are 
printed, user changes contents from 
600200 to 213 7 75 and opens the next sequen- 
tial location. 

User modifies contents of location 102 and 
commands PATCH to go to and open the loca- 
tion addressed by the contents of location 
102 (i.e., location 300). 

User enters + J to open and examine con- 
tents of preceding location (i.e., 277). 

User terminates current list operation 
by entering ALT MODE (symbol @) . 

PATCH prints a go-ahead symbol to indicate 
that it is ready for the next operation. 
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5.4 LR LIST COMMAND 

The LR List coittmand has the following format: 

>LR n) 

where LR initiates the listing operation for a previously selected 
READR-ins tailed Systems Program, and n represents the 13 bit "unrelo- 
cated" address (in octal) of the program location to be opened. 



NOTE 

PATCH automatically calculates and adds the needed 
relocation factor to the user's entry (i.e., n) . 
This enables the user to work directly from origi- 
nal unrelocated listings. 

The major difference between the "L" and "LR" list operations is that 
in L operations only absolute address information is output in responses 
and is required in modification procedures. In LR operations, however, 
the user must deal with both relocated and unrelocated addresses in 
list printouts and in register modification procedures. 

When the LR command is used to open word locations containing either 
data or non-memory reference instructions, the responses output are 
similar to those described for the L command. The only difference is 
that in the LR responses the address of the accessed location is given 
in relocated form relative to the original MACRO- assigned address. 



NOTE 

In the following paragraphs the symbol # is used to 
denote the relocation factor used by PATCH in the 
conversion of an unrelocated program into a system 
program. 



To illustrate, assum=^ that 6 is the unrelocated address of a user- 
selected location containing a non-memory reference instruction or data 
and that the relocation factor (#) is 17344. The response to the 
command: 
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>LR^6 ) 
is printed in the following form: 

>17344 + 6 / nnnnnn > 

Relocated Contents of location (6 digits) 
Address Op-Code and Operand or Data 

For example: 

>17352/Q17206> 

To illustrate, assume that a relocation factor of 17642 is current and 
that the selected program location 101 contains a JMP .+1 instruction. 
The response to the command: 

LR^li3l) 

is printed in the following form: 

1774 3/6 1774 4<!2rj?lJ2f2> 

Relocated Contents, Op-Code + # + Operand Unrelocated Operand, 

Location (6J3fj?i?i3fj? + 17642 + 102 Referenced Address 

Address Jm=6^^gi^9l (i.e., j3fjaflj?2) 

(177642+101) . + 1 = lJ2fl+l = 1J?2 

Printing an address operand in its unrelocated form enables the user to 
easily recognize the instruction containing it, and the referenced lo- 
cation without calculating and subtracting the PATCH relocation factor 
(#). 

The unrelocated referenced address within a memory- reference type instruc- 
tion is not printed by PATCH if it is less than the first address of the 
program; the address printed in angle brackets is always positive, though 
it may be zero. 

5.4.1 LR, Register Modification Procedure 

The contents of registers opened during LR operation are changed, as 
for L list operations, by the entry of an expression which is to re- 
place the contents of the current location.. New contents are entered 
immediately after the listed response and replace the current contents 
on termination of the response/user-input line. 
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Input expressions are formed using: 

a. Octal numbers up to six digits in length; 
PATCH always assume a six-digit input and 
right-justifies all numeric inputs (e.g. , 
an entry of 300g is recognized as 000300g) . 

b. Operators (symbols) as listed in Table 5-1. 

c. Symbolic representation of all PDP-15 basic 
instruction op-codes and operate group in- 
structions. 

d. The symbol # to represent the relocation 
factor of the currently selected, READR- 
ins tailed System Program. 



Command string terminators indicate the next sequential operation to 
be carried out (refer to Table 5-2) . 

5.4.2 Relocation and LR List Operation Examples 

The following examples use a single memory reference instruction to 
illustrate the relocation operations performed by READR in the instal- 
lation of a SYS file andthe manner in which the instruction may sub- 
sequently be examined using the LR command. 

EXAMPLE: 

a. Assume the instruction LAC. .300 located in MACRO as- 
signed location 200 of an unrelocated 400g-word pro- 
gram. 

b. The program is selected by the user and is j, tched 
onto a prepared system device medium as a SYS file 
using the READR function/ command. 

Program >Filenai[ie (name given at SGEN time) 

Name >READR Filename (current name of program) 

c. During READR operations, a relocation -"actor is cal- 
culated and added to all location addresses contained 
by the program. For a 400Q-word prograiu # = 17237„. 
Therefore, the relocatable input memory reference 
instruction 

200g LAC 300 

is relocated as 

t#+2001 (LAC #+300) 
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which equals 

17437g LAC 17537g 

or, in full octal form: 

17437 217537 

The relocated instruction is then output to the system 
device. 

d. To examine the instruction given in step c. in a READR- 
installed SYS file, the user calls PATCH, selects the 
program, and uses the LR command 

$ PATCH 

>Filename 

>LR^200) 

The responses output at the I/O console will be: 

>17437/217537<J2(J33J2J2(> 

e. To change the contents of the location, the user enters 
the desired expression and terminates the command string. 
If the contents contain an address, the relocation factor 
must be added to the new entry. 

For example, to change the address references in the con- 
tents of the location opened in step d from the 300g to 
305o Cunrelocated values), the user must enter the expres- 
sion: 

217544g 

if he knows the value of the relocation factor # (i.e. , 
17237 + 305) , 



EXAMPLE : 



or 

LAC #+305 



8 



>17436/217537< 00300> LACt+SJ^S ) 

changes the location to 

17436/217544 

and the terminator ) causes the next sequential loca- 
tion to be opened and a response output. 
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5.5 SYSTEM PROGRAM SYSBLK PARAMETER COMMANDS 

PATCH provides, as a convenient for the user, five separate commands 
which obtain and modify, if desired, SYSBLK parameters for the user 
selected program currently in core. By entering the appropriate com- 
mand from the following list and using suitable terminators as listed 
in Table 5-2, the user may start the listing at any specific point and 
proceed subsequently through the desired parameters. 

The commands, the parameters opened, and the word positions are as 
follows: 

Command SYSBLK Parameter Opened Word Position 

a) FbJ Number of first block used 3 

b) NB^ Number of blocks allotted to 4 

program 

c) FA^ First core address occupied 5 

when the SYSfile is loaded 
into core (13-bits) 

d) PS-ii^ Program Size 6 

e) SA J? Starting Address (13-bits) 7 



When examining the parameter group of a KEADR-installed System Pro- 
gram, the user must remember that: 

FA will give the address of the first (lowest) 
core locations occupied by the System Pro- 
gram/BBI combination when it is loaded. 

PS will give the TOTAL size of the System 
Program/BBI combination. 

SA will give the starting address of the BBI 
routine (first address above Transfer Vec- 
tor address table) . 



NOTE 
The program system parameter commands may not be used: 

a. when a program has not been selected or 
the command CTRL P (+F; has been entered; 

b. when SYSBLK has been selected; 

c. when the commands B, B+, or B- are in ef- 
fect. 
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The five SYSBLK Parameter commands operate in a manner similar to the 
List (L) command. When entered, the corresponding parameter location 
address and contents are printed out followed by a go-ahead symbol (>) 
as for the L command. As in other list operations, the user may, ac- 
cording to the manner in which terminators are used: 1) modify the 
opened register, 2) view the next sequential register, 3) view the 
preceding register, 4) jump to and view the location addressed by the 
contents of the last opened register, or 5) terminate the operation. 

The operations initiated by a Parameter command are carried out on the 
SYSBLK information contained by the PATCH command table. This SYSBLK 
data is obtained by PATCH when it is first loaded into core and prior 
to the start of user PATCH operations. ' On completion of each SYSBLK 
Parameter command operation (ALT MODE terminator used) , the modified 
(or unchanged) command table SYSBLK is copied onto the system at .DAT-14. 

Five separate commands are provided by PATCH as a convenience for the 
user; they permit the user to obtain a specific parameter or to start 
listing operations at a specific point with a simple straightforward 
command. The complete series of five program parameters may be ob- 
tained simply by starting with the FB command and advancing the list- 
ing operation through the next four sequential word locations. This 
method is the only way to modify .SYSBLK parameters without reloading 
PATCH since it also modifies the PATCH command table. 

EXAMPLE: 

The following example illustrates the use of a PATCH SYSBLK parameter 
command to obtain and modify the first address occupied, program size 
and starting address parameters for the system program currently in 
core. 

> FA^ parameter command 
00066/013670>13660^ first address opened and modi- 
fied 

00067/003747>3757-«^ program size opened and modified 

00070/013671>13661 (ALT MODE) starting address opened and 

> modified and operation termi- 
nated. 
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SECTION 6 
SUMMARY, OPERATING PROCEDURES AND ERROR MESSAGES 

6 . 1 CONTENTS 

Brief procedural descriptions of the operations needed before loading 
the PATCH program and for the performance of each PATCH function are 
given in this Section. Error detection and error messages are also 
described. 

6.2 PRE-LOAD OPERATIONS 

6.2.1 .DAT Slot Assignments 

The user must make the .DAT slot assignments given in Table 6-1 
immediately prior to loading the PATCH program. 

Table 6-1 Required .DAT Slot Assignments 
.DAT Slot used to 



-14 Input from and output to the device 
on which patches are to be made. 
The device handler is required only to 
perform .TRAN. 

-10 Input from the auxiliary device. 

The device handler must handle Dirnip 
Mode input and, if it is for a non- 
file oriented device, must handle 
image alpha mode. 

Permanently • "^ Output to the teleprinter. 



inently f 
signed \ _, 



Assigned \^_^ mput from the console keyboard or batch 

processing device. 



.DAT slot -10 can be assigned no device handler (NONE) if auxiliary 
input is not required. .DAT slots -3 and -2 cannot be changed. 

6.2.2 I/O Device Preparation 

The user must ensure that the I/O device assigned to .DAT-14 
(material to be patched) is WRITE ENABLED before starting PATCH 
operations . 
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If the device is 



1. DECtape unit - set the unit's WRITE ENABLED/WRITE LOCK 
switch to the WRITE ENABLED position. 

2. DECdisk - set the assigned logical disk unit's WRITE 

LOCKOUT switches to their ENABLED positions. ^RF Disk units only) 



6.3 CALLING PATCH 



PATCH is called by issuing the command PATCH from the system I/O 
console. When PATCH is loaded and running, it outputs its name 
and version number. For example: 



KM15 V5A 
$PATCH^ 
PATCH Vnn 



6 . 4 PATCH OPERATIONS 

The operations which may be performed using PATCH fall into four (4) 
functional groups. Procedures, in table form, are given for the List 
"L" and "LR" functions. 

6.4.1 Examination and Modification of Registers in Absolute Programs 
and Data Blocks 

See Table 6-2. 

6.4.2 Examination and Modification of Registers in PATCH-KEADR-installed 
System Programs 

See Table 6-3. 

6.4.3 Replacing Absolute Programs from External PATCH Files 
The required procedure is to: 

a. Select Program or data block to be patched (e.g. >EDIT_;) . 

b. Specify READ operation and input file with the command 
string 



>READ^_,[filename]^ (e.g., >READi_iEDPCHj) 
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The required procedure is : 

a. Select the system device area prepared (by SGEN) to 
receive the new SYS file (e.g., >NUFIL ^ ) . 

b. Enter the PATCH READR command using the following 
format : 

>READRi_innnnni_iLfilename]^ (e.g., >READRi_jl7600t_jNUFIL^) 

NOTE 

nnnnn represents the highest register the new SYS 
file will occupy when loaded into core. In the 
example, this is specified as 176j3pf„ which would 
leave a 36g-word buffer between the top of the SYS 

file and the first Bootstrap location. 

6.5 ERROR DETECTION 

PATCH, on the detection of an error, causes the following: 

1) the current function is terminated; 

2) the data block (program or selected block) current in 
the PATCH Block Buffer is output to the device at 
.DAT-14 if modifications had been made to the block; 

3) an appropriate error message is output at the user's 
I/O terminal. 

In the event of an .lOPS error, control is not automatically returned to 
the monitor. PATCH can be restarted by the entry of a CTRL P (+P) 
command. CTRL P is also useful in terminating a read operation in the 
event of an equipment malfunction (e.g., paper tape reader jams). 

In the event of an "I/O device not ready" error (I0PS4) , CTRL R may be 
used to continue the current operation after the device involved has 
been made ready. CTRL C may also be used to return control to the 
monitor; however, care must be taken not to use this command when a 
register is open since any modification made to the current block in 
core will be lost. 

6.6 ERROR MESSAGES 

The error messages output by PATCH are listed and described in 
Table 6-4. 
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Operation 



Item to be Patched 



BLOCK 



PROGRAM 



PROGRAM 

SYSBLK 

PARAMETERS 



SELECT ITEM 
TO BE 
PATCHED 



>B, .a>) or 

>B+ n J or 
>B-^n; 



>Prog. Name^ 



>Prog. Name ^ 



SELECT 
REGISTER OR 
PARAMETER 



> L 



'^-^ 



>L r\.J 



> Fh J or 

> FB ^ or 
>NB^ or 
>PSJ or 
>SA^ 



MODIFY 
OPENED 
ITEM 



e.g. 



ENTER NEW CONTENTS IMMEDIATELY AFTER RESPONSE 
OUTPUT WHEN LOCATION WAS OPENED. 

, > Address/ Old Contents > New Contents 



SELECT 

NEXT 

OPERATION 



TERMINATE RESPONSE LINE ACCORDING TO DESIRED NEXT 
OPERATION: 






ALT 
MODE 



go to next sequential location open 
and list address and contents 

go to preceding register, open and 
list address and contents 

go to register identified by contents 
of current register, open and list 
address and contents 

terminate current list operations 



Table 6-2, Procedure for Modifying Registers in Absolute System Programs 
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Operation 



SELECT ITEM 



SELECT REGISTER OR 
PARAMETER 



MODIFY OPENED 
ITEM 



SELECT NEXT 
OPERATION 



T4-OTTn T^n Ro P^-f-riViorl 



PROGRAM 



>Prog. Name^ 



>LR n J 



PROGRAM SYSBLK 
PARAMETERS 



>Prog. NameJ 



>PA } or 

>FB J or 

>NB-^ or 

>PS J or 
>SA*' 



ENTER NEW CONTENTS IMMEDIATELY AFTER RESPONSE 
OUTPUT WHEN LOCATION WAS OPENED. USE RELOCATION 
FACTOR (#) WHEN CHANGING MEMORY REFERENCE OR 
TRANSFER VECTOR REGISTERS. 



e.g. , standard register 

relocated , old 



/ 



new 



address '' contents contents 

memory reference instruction or transfer 
vector 



relocated , 
address 



old unrelocated 
contents address of 
contents 



new 
contents 

+ # 



TERMINATE RESPONSE LINE ACCORDING TO DESIRED 
NEXT OPERATION: 

\ go to next sequential location 

open and list address and con- 
tents 






ALT 
MODE 



go to preceding register, open 
and list address and contents 

go to register identified by 
contents of current register, 
open and list address and con- 
tents. 

terminate current list operations 



Table 6-3. Procedure for Modifying Registers in PATCH-Installed System 
Programs 
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Table 6-4 



Printout 



ERROR MESSAGES 



Meaning 



ILLEGAL COMMAND 



NOT OCTAL DIGIT 



TOO MANY DIGITS 



ADDRESS OUT OF RANGE 



a. An attempt was made to issue a command 
before a file or block was selected. 

b. Command unrecognizable. 

A character other than an octal digit was 
encountered where an octal digit was 
expected. 

The command string contains an octal number 
with more than 6 digits. 

a. The address requested is not within the 
legal range of the currently selected 
program or block. 

b. Address or size argument of a SYSBLK 
command is greater than 17645 _ or is 



negative. 



8 



CHECKSUM ERROR 



FILE NOT FOUND 



ILLEGAL BLOCK # 



ILLEGAL SIZE 



MORE THAN 256 

TRANSFER VECTORS 

NOT RELOCATABLE BINARY 



.GLOBL NOT ALLOWED 



LAST ADDRESS GREATER 
THAN 17636 



Bad data read in from auxiliary input device 
(checksum, parity, or validity bits) - try 
again. 

The file named in a READ or READR command does 
not exist on the auxiliary device. 

The block number specified in a Block 
Selection command was less than )?. 

a. The program size (PS command) exceeds the 
number of blocks allotted for the current 
program. 

b. The size of the program (including the 

bank bit initialization routine supplied 

by PATCH) input by a READR command exceeds 

the number of blocks allotted (during 

system generation) for the SYS file or 

is greater than nnnnn-20 . 

o 

The program being input by a READR command 
contains more than 256 transfer vectors. 

The program being input by a READR command 
is not a relocatable binary file. 

The program being input by a READR command 
contains an external .GLOBL (internal .GLOBL 
ignored) . 

The last address of the program input by a 

READR command is greater than 17636 _. 

o 
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APPENDIX A 



SYSTEM BLOCK (SYSBLK) DESCRIPTION 



A.l SYSTEM BLOCK (SYSBLK) 

In each of the primary PDP-15 monitor systems (ADSS, DOS) the monitor 
contains a System Block table (abbreviated as SYSBLK) which contains 
the name, physical parameters and 1/0 information for each system pro- 
gram in the software system. 

The information contained by SYSBLK in the initial operating system is 
determined during System Generation procedures (refer to the appropri- 
ate SGEN manual - Table 1-1) . SYSBLK is used by the system loader 
programs in locating and loading selected (called) System Programs into 
core. 

PATCH, when first loaded into core, checks for a SYSBLK at .DAT -14 and, 
if one is present, it loads the SYSBLK Parameter Table into core as a 
PATCH Command Table. This command table is used unchanged during all 
subsequent PATCH System Program operations, including SYSBLK modifica- 
tion operations. 

SYSBLK, itself, is divided into two distinct areas (see Figure 2-1) , a 
Parameter Table, and a Communications Table (named COMBLK in DOS systems) 
PATCH operations normally concern only the SYSBLK Parameter Table. 



ADSS 



SYSBLK 





J 




PARAMETER 


/ SYSBLK 






FREE AREA 




COMMUNICATIONS 
DATA GROUPS 


COMBLK 











DOS 



Figure A-1 
System Block, Overall Configuration 
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A. 1.1 SYSBLK Parameter Table 

Both the ADSS and DOS SYSBLK parameter tables contain separate seven- 
word parameter groups for each System Program in the operating system. 
Each parameter group consists of the following: 



WORD 



1 & 2 



CONTENTS 

Name of the System Program or overlay (i.e., PATCH, 
DDT, EDIT, etc.) in .SIXBT. 

The number of the first system device block occupied 
by this System Program or overlay. 

The amount of system device blocks allotted to con- 
tain the program. For PATCH-ins tailed programs, this 
number is alio tted daring user SGEN procedures. 

The address (13-bit) of the first core locations that 
will be occupied by the System Program when it is 
loaded. 



The size of the program. 

The program starting address (13-bit) 



An example of an ADSS System Program parameter table is given in 
Figure 2-2. 



OCTAL 
PRINTOUT 


WORD 


CONTENT 


00010 
000\\ 


^5j2l411 
240000 


000\2 


^J2fj363j2f 


J30|2fl3 


000012 



0001i 0Yi000 

00015 004636 
0001^ 01Z000 



INTERPRETATION 



Program name "EDIT" in .SIXBT code. 

The first block occupied by EDIT is 
6303. 

Twelve blocks (octal) are allotted to 
hold the program EDIT. 

The first core location' occupied by 
EDIT is 130c)0g. 

EDIT consists of 4636o words. 

o 

Program start address' is at core loca- 
tion 13000g. 



Figure A-2 



System Program EDIT SYSBLK Parameter Group 



'At load time, the bank bits of the highest 8K system bank are added to 
this address to properly locate the program in the highest" bank. 
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A. 1.2 Communications Table 

ADSS system block communication areas contain individual .DAT slot lists 
for each system program and a master .DAT slot list pointer table. 

DOS system block COMBLK area contains individual communication data 
groups which store .DAT slot, buffer, and overlay information for 
each system program. 
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APPENDIX B 



SYSTEM PROGRAMS, GENERAL DESCRIPTION 



System Programs have a unique feature in that they are loaded into 
core and are started by only the entry of a single user command (i.e., 
program name) at the system console keyboard. This feature is imple- 
mented by name, control parameters, and I/O device information con- 
tained for each System Program in the system SYSBLK Parameter and 
Communication (COMBLK) tables. The information contained in SYSBLK 
enables the Keyboard Monitor to recognize System Program names (as 
stored in SYSBLK) and causes it to initiate the loading of the identi- 
fied program into core. 

System Programs and their associated Device Handlers are loaded into 
core from the system device by the System Loader (.SYSLD) program. 

The placement of System Programs and their device handlers in core is 
illustrated in Figure 2-3. As shown: 

1) System Programs are always loaded immediately below the 
Bootstrap in the highest portion of the highest 8K bank 
in the system. 

2) In systems which include an extra 4K page (e.g., 12K, 
20K, 28K, etc.) the extra 4K portion is used, during 
loading operations, only for handlers. 

3i The lowest register which a System Program may occupy 
is 20 „ in the highest 8K bank of the system; handlers 
and free core may be located anywhere in the system. 

System Programs are stored on the ^stem device as absolute executable 
files identified by the file name extension "SYS" and are commonly 
referred to as "SYS files". Software is supplied to the user and 
contains a standard group of commonly used utility and language pro- 
grams installed on some medium (e.g., DECtape) as SYS files. The 
SGEN and PATCH utility programs can be used to delete the supplied 
SYS files or replace them with other Digital-supplied programs or 
with user programs. Table 2-1 lists the names and SYSBLK entry 
names of the System Programs supplied with PDP-15 software systems. 
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I 

EXTRA ' 
4K PAGE I 



BOOTSTRAP 



SYSTEM 

PROGRAM 

(SYSfile) 



DEVICE 
HANDLERS 



RESIDENT 
MONITOR 



.11111^ + N 



.17636g + N 



,SCOM + 3 



.000200 + N lower limit 
for SYSfile 



,SCOM + 2 



,SCOM + 1 



LEGEND: N = 00000 for 8K systems 
= 20000 for 16K systems 
= 40000 for 24K systems 
= 60000 for 32K systems 



Figure B-1, Memory Map, Loading System Programs 
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INDEX 



•ABS macro program, 4-2 

Absolute address information, 5-6 

Absolute address values, 3-3 

Absolute files transfer, 4-1 

ADDRESS OUT OF RANGE error, 4-2 

Address relocation, 3-2 

Addresses in LR List operations, 5-6 

ALT MODE, 5-4 

Asterisk (*) symbol, operator, 5-3 

At symbol C@) (ALT MODE), 5-4 



B command (Block Select) , 2-3 
Bank Bit Initialization routine, 
3-2 through 3-5 

word location requirement, 3-5 
Batch control operation, 1-1 
Block relocation, 2-3 
Block Select (B) , 2-3 

command, 4-2 



Calling PATCH, 6-2 

Changes to SYSBLK parameters, 4-4, 

4-5 
Command , 
B, 2-3 
L, 5-4 
LR, 5-6 
READ , 4-1 

READR, 3-1, 3-2, 3-3 
SYSBLK commands, 
FA, 5-10 
5-10 
5-10 
5-10 
5-10 



Doc\aments , supporting , 
Dump Mode, 6-1 
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FB, 
NB, 
PS, 
SA, 
Commands , 

Block Select, 4-2 
Program Select, 4-2 
Select, 5-1 
SYSBLK, 5-10 
Comments, 2-3 
Common data storage, 3-5 
COMMON references, 3-2 
Communications Table, A-3 
Conversion of relocatable file 
to absolute SYS file, 3-1 
Core image size, 3-2 
CTRL Q area ( + QAREA) , 2-1 



.DAT slot assignment, 1-3, 6-1 
.DAT slot lists, A-3 
Data flow paths, 1-3, 1-4 
DECdisk preparation, 6-2 
DECtape preparation, 6-2 
Device assignments, 6-1 
Disk preparation, 6-2 



Error , 

address out of range, 4-2 
detection, 6-3 
messages, 6-6 
Evaluation of expression, 5-3 
Examples of Select, List and 

Modification procedures, 5-5 
Examples, Relocation and LR List 

operation, 5-8, 5-9 
Exclamation point symbol (1), 

operator, 5-3 
Expressions, 5-2 
evaluation of, 5-3 
null, 5-3 



File conversion, relocatable 

to absolute, 3-1 
Filename extension, READ 

command, 4-2 
Filename omission, 3-1 
Filename, paper tape files, 4-2 
Function, 

List, 5-1 

load, 3-1 

READ load, 4-1 

Select, 2-1 
Functions of PATCH, 1-3, 6-2 



•GLOBL references, 3-2 
Go ahead symbol (>) , 5-5 



Identification of program, 2-1 
Image alpha mode, 6-1 
Inclusive OR, 5-3 
Indexed instructions, 3-2 
Input devices, 1-1, 6-1 
Input expressions for register 

modification, 5-8 
Input file requirements, 3-2 
I/O device preparation, 6-1 
I/O data flow paths, 1-3, 1-4 



LAW symbol, 5-3 

Linking Loader system program, 3-3 

List function, 5-1 

L command, 5-1, 5-4 

LR command, 5-1, 5-6 

SYSBLK parameter command, 5-1 
S'-IO 
List operation, 5-2 

line terminator, 5-4 
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L List command, 5-4, 5-5 
LR List command, 5-6 

register modification procedure, 5- 
Load address specification, 3-5 
Load function, 3-1 
Loading absolute programs, 4-1 
Loading relocated core image 

systan programs, 3-6 
.LOC statements as pointers, 4-3 



Relocation factor, 3-3, 5-6 
symbol (#), 3-3, 5-6, 5-8 

Relocation operation, example 
LR command, 5-8, 5-9 

Replacement (complete) of 

programs or data blocks, 4-4 

Right angle bracket (>) (go- 
ahead symbol) , 5-5 

Routine, Bank Bit Initializa- 
tion, 3-2 through 3-5 



MACRO 15 assembler, 3-3 
Major functions of PATCH, 1-3 
Memory Map, READR SYS file, 3-7 
Messages, error, 6-6 
Minus sign (-) operator, 5-3 
Modes , 

dump, 6-1 

image alpha, 6-1 



Naming program, 2-1 
Null expression, 5-3 
Number symbol C# ) usage (relocation 
factor symbol), 3-3, 5-6, 5-8 



Operators recognized by PATCH, 
Output device, 6-1 
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Parameter changes, SYSBLK, 4-4, 4-5 
Parameter table, SYSBLK, A-2 
Partial overlay PATCH programs, 4-4 
Plus sign (+) operator, 5-3 
Pointers t-LOC statements) , 4-3 
Pound symbol (#) usage (relocation 

factor symbol), 3-3,5-6,5-8 
Precautions, READ operations, 4-4 
Preload operations , 6-1 
Procedure for modifying registers, 

in absolute system programs, 6-4 

in PATCH installed system 
programs, 6-5 
Program 

name , 2-1 

size, 3-2, 3-3 

writing, 4-3 
Program Select command, 4-2 



Select command, 5-1 
Select function, 2-1 

Block Select (B) command, 2-3 

Program Select command, 2-1 
SGEN utility program, B-1 

procedures, 3-1, 3-2 
Size 

of core image, 3-2 

of program, 3-2, 3-3 
Summary, 6-1 

Supporting documents, 1-2 
SYS files, B-1 
SYSBLK parameters, 3-2, 4-1 

changes, 4-4, 4-5 

commands, 5-10 

command example, 5-11 

table, A-2 
SYSBLK (System Block), 2-1, A-1 
.SYSLD (system loader), 3-4,3-6,8-1 
System Block, see SYSBLK 
System generation procedures 

(SGEN) , A-1 
System Loader (.SYSLD) program, 

3-6, B-1 
System programs, loading, B-1 
System Program SYSBLK parameter 

commands, 5-10 
System programs supplied with 
DOS and ADSS, 2-2 

Tab symbol (-^), 5-3 

Termination of PATCH operations, 4-4 

Terminators, list operation 

command string, 5-4 
Transfer vectors, 3-2 

data word format, 3-4 
Two^s complement addition, 5-3 
Two's complement subtraction, 5-3 



READ command, 4-1 

load operation, 4-2 
READ operations, precautions, 4-4 
READR file relocation calculation, 

3-3 
READR Load command, 3-1, 3-3 

input file requirements, 3-2 

procedures, 3-2 
READR System Communications area, 3-5 
Register modification functions, 5-1 
Relocatable programs installed as 

absolute SYS files, 6-3 
Relocation of block, 2-3 



Writing PATCH programs, 4-3 



XOR (exclusive OR) , operator, 5-3 
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HOW TO OBTAIN SOFTWARE INFORMATION 

Announcements for new and revised software, as well as programming notes, 
software problems, and documentation corrections are published by Software 
Information Service in the following newsletters. 

Digital Software News for the PDP-8 & PDP-12 

Digital Software News for the PDP-il 

Digital Software News for the PDP-9/15 Family 

These newsletters contain information applicable to software available from 
Digital's Program Library, Articles in Digital Software News update the 
cumulative Software Performance Summary which is contained in each basic 
kit of system software for new computers. To assure that the monthly Digital 
Software News Is sent to the appropriate software contact at your installation, 
please check with the Software Specialist or Sales Engineer at your nearest 
Digital office. 

Questions or problems concerning Digital's Software should be reported to 
the Software Specialist. In cases where no Software Specialist Is available, 
please send a Software Performance Report form with details of the problem to: 

Software Information Service 
Digital Equipment Corporation 
146 Main Street, Bidg. 3-5 
Maynard, Massachusetts 01754 

These forms which are provided In the software kit should be fully filled out 
and accompanied by teletype output as well as listings or tapes of the user 
program to facilitate a complete investigation. An answer will be sent to the 
individual and appropriate topics of general interest will be printed in the 
newsletter. 

Orders for new and revised software and manuals, additional Software Per- 
formance Report forms, and software price lists should be directed to the 
nearest Digital Field office or representative. U.S.A. customers may order 
directly from the Prcj^i-nm Library in Maynard. When ordering, include the 
code number and a brief description of the software requested. 

Digital Equipment Computer Users Society (DECUS) maintains a user library 
and publishes a catalog of programs as well as the DECUSCOPE magazine 
for its members and non-members who request It. For further information 
please write to: 

DECUS 

Digital Equipment Corporation 
146 Main Street, Bidg. 3-5 
Maynard, Massachusetts 01754 
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